Skip to content

Add Go CLI standards guidance#415

Merged
codeforester merged 1 commit into
masterfrom
documentation/414-20260602-go-cli-standards
Jun 2, 2026
Merged

Add Go CLI standards guidance#415
codeforester merged 1 commit into
masterfrom
documentation/414-20260602-go-cli-standards

Conversation

@codeforester
Copy link
Copy Markdown
Owner

Summary

  • Add a Go CLI standards section to STANDARDS.md.
  • Recommend Cobra as the default framework for non-trivial Go CLIs while allowing tiny stdlib-only tools.
  • Clarify that Go binaries do not use base-wrapper; Base should orchestrate them through manifests, basectl test, and basectl run.
  • Document Go CLI behavior expectations for stdout/stderr, JSON, destructive actions, exit codes, context, and validation.
  • Record the standards update in the changelog.

Validation

  • git diff --check
  • LC_ALL=C grep -n '[^ -~]' STANDARDS.md CHANGELOG.md || true\n- rg -n "Go CLI Standards|Cobra|base-go-cli|Go binaries are compiled|basectl test <project>|go test ./\\.\\.|Go CLI guidance" STANDARDS.md CHANGELOG.md\n\nDocs-only change; local runtime tests were not run.\n\nCloses Add Go CLI guidance to Base standards #414

@codeforester codeforester merged commit ef17e89 into master Jun 2, 2026
16 checks passed
@codeforester codeforester deleted the documentation/414-20260602-go-cli-standards branch June 2, 2026 14:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant